home *** CD-ROM | disk | FTP | other *** search
/ Cinema Studio: Frank Herrmann / Cinema Studio - Frank Herrmann.iso / tools / pbm / manuals / hpcdtoppm.man < prev    next >
Text File  |  1994-05-21  |  11KB  |  397 lines
  1.  
  2.  
  3.  
  4.      hpcdtoppm(1L)         AMIGA (3 March 1994)          hpcdtoppm(1L)
  5.  
  6.  
  7.  
  8.      NAME
  9.           hpcdtoppm - convert a Photo-CD file into a portable bitmap
  10.           file
  11.  
  12.      SYNOPSIS
  13.           hpcdtoppm infile [-a] [{-C|-0|-Overview file opt] [-c0]
  14.           [-c-] [-c+] [-crop] [-d] [-dpi f] [-eps] [-epsd] [-epsg]
  15.           [-fak scale] [-hori] [-i] [-l] [-m] [-n] [-pb pos] [-pgm]
  16.           [-ph height] [-pl pos] [-pos] [-ppm] [-ps] [-psd] [-psg]
  17.           [-pw width] [-r] [-rep] [-S long short] [-s] [-vert] [-x]
  18.           [-ycc] [-1|-Base/16 |-128x192] [-2|-Base/4 |-256x384]
  19.           [-3|-Base |-512x768] [-4|-4Base |-1024x1536] [-5|-16Base
  20.           |-2048x3072] [-6|-64Base |-4096x6144] [outfile]
  21.  
  22.      DESCRIPTION
  23.           This program accepts Photo-CD image or overview file data
  24.           from the specified input file, infile (or, if the resolution
  25.           is lower than 64Base and the file argument is specified as
  26.           -, from standard input), and writes either Portable Bitmap
  27.           Format or POSTSCRIPT to the specified output file (or to
  28.           standard output if no file is specified).
  29.  
  30.           On a standard Photo-CD, image files appear in
  31.           photo_cd/images, where they appear in files with names of
  32.           the form imgnnnn.pcd, where nnnn is a 4-digit-number.  The
  33.           overview file appears in photo_cd/overview.pcd.
  34.  
  35.           Photo-CD images are stored using as many as 6 different
  36.           resolutions:
  37.                     Format              Resolution
  38.                     ------              ----------
  39.                     64Base              4096x6144 (ProPhotoCD only)
  40.                     16Base              2048x3072
  41.                     4Base               1024x1536
  42.                     Base                512x768
  43.                     Base/4              256x384
  44.                     Base/16             128x192
  45.  
  46.           The overview file employs Base/16 format.
  47.  
  48.      OPTIONS
  49.           Invoking hpcdtoppm without arguments produces a list of
  50.           default values.  Note that you can supply only one size
  51.           option.
  52.  
  53.           -a   Automatically determine image orientation (this option
  54.                is experimental, and does not work for overview files).
  55.  
  56.           {-C | -0 | -Overview | -O } file opt
  57.                Extract all images from an overview file.  The
  58.                mandatory file argument is the name of a ppm file;
  59.                output files are named filennnn, where nnnn is a 4-
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 5/19/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      hpcdtoppm(1L)         AMIGA (3 March 1994)          hpcdtoppm(1L)
  71.  
  72.  
  73.  
  74.                digit number.  Overview images are extracted in their
  75.                original Base/16 format.  The value of opt determines
  76.                the orientation of the contact sheet image; recognized
  77.                values are:
  78.  
  79.                n    Do not rotate the image.
  80.  
  81.                l    Rotate the picture counter-clockwise (portrait
  82.                     mode).
  83.  
  84.                r    Rotate the picture clockwise (portrait mode).
  85.  
  86.           -c0  Do not correct (brighten or darken) the image.
  87.  
  88.           -c-  Darken the image.
  89.  
  90.           -c+  Brighten the image.
  91.  
  92.           -crop
  93.                Cut off the black frame which sometimes appears at the
  94.                image borders.
  95.  
  96.           -d   Show only the decompressed difference rather than the
  97.                complete image (applicable only to 4Base and 16Base
  98.                images).
  99.  
  100.           -dpi res
  101.                Set the printer resolution to res for dithered
  102.                POSTSCRIPT images.
  103.  
  104.           -eps Write a RGB Encapsulated POSTSCRIPT color image.
  105.  
  106.           -epsd
  107.                Write a Floyd-Steinberg dithered image in Encapsulated
  108.                POSTSCRIPT.
  109.  
  110.           -epsg
  111.                Write a grayscale image in Encapsulated POSTSCRIPT.
  112.  
  113.           -fak scale
  114.                Set the scaling factor for dithered POSTSCRIPT images
  115.                to scale.
  116.  
  117.           -hori
  118.                Flip the image horizontally.
  119.  
  120.           -i   Send information from an image file header to standard
  121.                error.
  122.  
  123.           -l   Rotate the picture counter-clockwise (portrait mode).
  124.  
  125.           -m   Write messages about the phases of decoding to standard
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 5/19/94)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      hpcdtoppm(1L)         AMIGA (3 March 1994)          hpcdtoppm(1L)
  137.  
  138.  
  139.  
  140.                error.
  141.  
  142.           -n   Do not rotate the image.
  143.  
  144.           -pb pos
  145.                Set the bottom position of the POSTSCRIPT image to pos.
  146.  
  147.           -pgm Write a pgm (grayscale) image.
  148.  
  149.           -ph height
  150.                Set the height of the POSTSCRIPT image to height.
  151.  
  152.           -pl pos
  153.                Set the leftmost position of the POSTSCRIPT image to
  154.                pos.
  155.  
  156.           -pos Print the relative starting position of the data for
  157.                the current resolution.
  158.  
  159.           -ppm Write a ppm RGB (color) image.
  160.  
  161.           -ps  Write a RGB POSTSCRIPT color image.
  162.  
  163.           -psd Write a Floyd-Steinberg dithered image in POSTSCRIPT.
  164.  
  165.           -psg Write a POSTSCRIPT grayscale image.
  166.  
  167.           -pw width
  168.                Set the width of the POSTSCRIPT image to width.
  169.  
  170.           -r   Rotate the picture clockwise (portrait mode).
  171.  
  172.           -rep Try to jump over reading errors in the Huffman code.
  173.  
  174.           -S long short
  175.                Cut out a subrectangle with boundaries defined by the
  176.                values:
  177.  
  178.                long For the longer side of the image.
  179.  
  180.                short
  181.                     For the shorter side of the image.
  182.  
  183.                where long and short take one of two forms:
  184.  
  185.                a-b  Cut from position a to position b.
  186.  
  187.                a+b  Starting at offset a, cut a length of b.
  188.  
  189.                and where a and b are either integers representing
  190.                pixel locations, or floating point values over the
  191.                range [0.0 ... 1.0], representing the fraction of the
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 5/19/94)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      hpcdtoppm(1L)         AMIGA (3 March 1994)          hpcdtoppm(1L)
  203.  
  204.  
  205.  
  206.                length of a side.
  207.  
  208.           -s   Apply a simple sharpness operator to the luminosity
  209.                channel.
  210.  
  211.           -vert
  212.                Flip the image vertically.
  213.  
  214.           -x   Overskip Mode (applicable to Base/16, Base/4, Base and
  215.                4Base).  In Photo-CD images the luminosity channel is
  216.                stored in full resolution, the two chromaticity
  217.                channels are stored in half resolution only and have to
  218.                be interpolated.  In Overskip Mode, the chromaticity
  219.                channels of the next higher resolution are taken
  220.                instead of interpolating.  To see the difference,
  221.                generate one ppm with and one ppm without this flag.
  222.                Use pnmarith(1L) to generate the difference image of
  223.                these two images.  Call ppmhist(1L) for this difference
  224.                or show it with xv(1L) (push the HistEq button in the
  225.                color editor).
  226.  
  227.           -ycc Write the image in ppm YCC format.
  228.  
  229.           -1|-Base/16|-128x192
  230.                Extract the Base/16 image.
  231.  
  232.           -2 | -Base/4 | -256x384
  233.                Extract the Base/4 image.
  234.  
  235.           -3 | -Base | -512x768
  236.                Extract the Base image.
  237.  
  238.           -4 | -4Base | -1024x1536
  239.                Extract the 4Base image.
  240.  
  241.           -5 | -16Base | -2048x3072
  242.                Extract the 16Base image.
  243.  
  244.           -6 | -64Base | -4096x6144
  245.                Extract the 64Base image. This resolution can be
  246.                extracted from ProPhotoCD images only. The path of the
  247.                64Base extension files is derived from the path to the
  248.                image file. This means that it doesn't work on stdin an
  249.                the directory structure must be the very same as on the
  250.                ProPhotoCD.
  251.  
  252.      POSTSCRIPT OUTPUT
  253.           For POSTSCRIPT output (options -ps, -eps, -psg, -epsg, -psd,
  254.           -epsg) you can define both the resolution and placement of
  255.           the image.  Both size and position are specified in points
  256.           (1/72 inch).
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 5/19/94)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      hpcdtoppm(1L)         AMIGA (3 March 1994)          hpcdtoppm(1L)
  269.  
  270.  
  271.  
  272.           The position of the image (where the origin is assumed to be
  273.           at the lower left corner of the page) is controlled by the
  274.           -pl and -pb options (applicable at all resolutions).
  275.  
  276.           The size of color and grayscale images is changed with the
  277.           -pw and -ph options.  Every image pixel is mapped onto one
  278.           POSTSCRIPT pixel.
  279.  
  280.           There are three modes of control for dithered POSTSCRIPT:
  281.  
  282.           Image size
  283.                (-pw and -ph)
  284.  
  285.           Printer resolution
  286.                (-dpi)
  287.  
  288.           Scaling factor
  289.                (-fak)
  290.  
  291.           These three factors are interdependent, hence no more then
  292.           two can be specified simultaneously.  Using -dpi and the
  293.           -pw/-ph options together often yields pleasing results.
  294.           Even using the default values for these options will produce
  295.           results differing from those obtained without use of the
  296.           options.
  297.  
  298.      BUGS
  299.           The program ignores read protection.
  300.  
  301.           The -i option is not working correctly.
  302.  
  303.           Available information obout the Photo-CD format is vague;
  304.           this program was developed by trial-and-error after staring
  305.           at hex-dumps.  Please send bugs reports and patches to the
  306.           author.
  307.  
  308.      SEE ALSO
  309.           pnmarith(1L), ppm(5L), ppmhist(1L), ppmquant(1L),
  310.           ppmtopgm(1L), ppmtorgb3(1L), xv(1L)
  311.  
  312.      VERSION
  313.           The name hpcdtoppm stands for "Hadmut's pcdtoppm," to make
  314.           it distinguishable in the event that someone else is
  315.           building a similar application and naming it pcdtoppm.  This
  316.           is version 0.6.
  317.  
  318.      AUTHOR
  319.           Copyright (c) 1992, 1993, 1994 by Hadmut Danisch
  320.           (danisch@ira.uka.de).  This software is not public domain.
  321.           Permission to use and distribute this software and its
  322.           documentation for noncommercial use and without fee is
  323.           hereby granted, provided that the above copyright notice
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 5/19/94)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      hpcdtoppm(1L)         AMIGA (3 March 1994)          hpcdtoppm(1L)
  335.  
  336.  
  337.  
  338.           appear in all copies and that both that copyright notice and
  339.           this permission notice appear in supporting documentation.
  340.           This software may not be sold or used for profit-making
  341.           activities.
  342.  
  343.           Manual page extensively modified by R. P. C. Rodgers
  344.           (rodgers@nlm.nih.gov).
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 5/19/94)
  394.  
  395.  
  396.  
  397.